home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 054a / fmagic10.zip / FM.DOC < prev    next >
Text File  |  1993-01-30  |  20KB  |  395 lines
  1.                                 File Magician
  2.                                     V1.0
  3.                              Copyright 1993-1994
  4.                               by Terry Bullard
  5.                                for Windows 3.1
  6.  
  7.  
  8.     Welcome to File Magician!!  First I must tell you a bit about myself and
  9.  my company, then I'll get to the grit of the program.  My name is Terry
  10.  Bullard and I've been programming on the Amiga computer since 1985.  I love
  11.  creating utilities and have sold many to the different magazines, customed
  12.  to different software companies, and have just sold out right to distributers.
  13.  We are just a small company, man and wife, I do the programming and she does
  14.  all the work.  After we had graduated to the PC world it didn't take me long
  15.  to discover that there were a few things that would make life a good deal
  16.  easier when dealing with the PC.  File Magician is one of the first programs
  17.  I felt would benefit PC users. After talking with other Amiga users who are
  18.  also PC users it was voted unanimous that the PC world needs a good file and
  19.  directory program. Disk Master, Directory Opus, are the heart of the Amiga
  20.  World.  Now that I have joined the ranks of the PC I hope to bring you the
  21.  best of both worlds, and File Magician is well on its way to that.
  22.     My main goal in all programs is to make it as user friendly as possible
  23.  and I do not spare the coding or time to do so.  I believe that software is
  24.  suppose to take the work out of whatever you are doing and should be able to
  25.  to be used with little or no documentation at all.  The interface should be
  26.  nice and should be straight forward in what it does.  I also believe that the
  27.  customer is right!  A lot of places (no names) automatically assume that the
  28.  customer is a dummy and if the customer did this or the customer did that or
  29.  the customer bought this etc., I don't!  To me it means that I goofed, I
  30.  should have taken that problem into account within the program. What this all
  31.  boils down to is that I want to hear from you, I need your input so I can do
  32.  my best in my programming.
  33.  
  34.  
  35.  
  36. Description
  37. ~~~~~~~~~~~
  38.    Well, enough said on that subject!  Now to tell a little about File Magician.
  39.  File Magician has a similar interface as Disk Master v1.4 for the amiga, if
  40.  you own a amiga and don't have Disk Master, get it , it is a must have.
  41.  File Magician has two view windows, one is always the 'Source Window' and one
  42.  is always the 'Destination' window. Source and Destination can be swapped by
  43.  clicking the LMB in the window or in the path bar above the window.  The
  44.  clicked area will then become the 'Source' window.  The 'Source' window will
  45.  have a red box around it plus the little toggle bar between the windows at the
  46.  top of the screen will also point to it.  In the center of the screen between
  47.  the two windows will be a column of push buttons. The first six buttons are
  48.  for your drive configuations.  The program will automatically configure to
  49.  your current devices. The following buttons will perform the different
  50.  functions as is explained below.  Let me add at this point that File Magician
  51.  is a shareware program and that it is for evaluation only.  Somewhere there
  52.  had to be a stopping point with File Magician as a evaluation program.
  53.  File Magician can only grow from this point.  I have over 50 planned functions
  54.  that File Magician will have as time goes on, not counting new ideas that will
  55.  be generated by time and user input. Basically File Magician has unlimited
  56.  growth potential!  User registation increases that potential many times over.
  57.  
  58.  
  59.  
  60. So Just What Is File Magician?
  61. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  62.     File Magician is a program that EVERY PC owner must have.  If you own a
  63.  computer, at sometime during your computer lifetime you will Have To make
  64.  some type of file or directory adjustment to your hard drive or floppy disks.
  65.  File Magician is designed to be as simplistic as possible in allowing you to
  66.  manage your files and directories.  File Magician is for all levels of users,
  67.  beginning to advanced.
  68.  
  69. Requirments
  70. ~~~~~~~~~~~
  71.     A computer
  72.     Windows 3.1
  73.     Be Registered
  74.  
  75.  
  76. How To Register
  77. ~~~~~~~~~~~~~~~
  78.     There are a couple of ways to register 'File Magician'.  First you can send
  79.  a check or money order for $40.00 US Funds to:
  80.  
  81.     Bullard Software
  82.     3291 Mt. View Rd.
  83.     Ferndale, Wa.   98248
  84.  
  85.  OR
  86.      by Trust Mail.
  87.  
  88. Trust Mail
  89. ~~~~~~~~~~
  90.     Trust Mail is a term that we invented.  Most places insist that first you
  91.  send them money and then they will send you your requested items.  You trust
  92.  them to do this after you have parted with your money.  With trust mail, we
  93.  will send you our software first and when you receive it, we will trust that
  94.  you will send us back a check or money order for it.  All you need do is to
  95.  pick up your phone and dial the number supplied below and then register.
  96.  Don't be surprised if you get just a "Hello" instead of "Hello this is Bullard
  97.  Software".  I have a really hard time being so formal!  After you register
  98.  we will within 24 hours have 'File Magician' on its way to you, first class
  99.  and postage paid by us.  As our company grows with your support we will add
  100.  additional lines for ordering and support.  For now you can order between
  101.  5:00 P.M. and 9:00 P.M. Pacific Standard Time.  Keep in mind that there is
  102.  three hours difference between here and the east coast.
  103.     Also  I must keep Trust Mail limited to the USA and Canada.  Don't get
  104.  me wrong for those that don't live there, I must see how this works out first.
  105.  I do hope you understand.
  106.  
  107.     CALL NOW:     1-(206)-384-6740
  108.  
  109. What You Get
  110. ~~~~~~~~~~~~
  111.     Once you register, we will send you 'File Magician' without the dialog boxes
  112.  that appear when any item is first clicked.  The program will be the lastest
  113.  update of File Magician.  A printed manual that to begin with will be soft
  114.  bound.  With the planned growth of File Magician it is not feasible to have
  115.  any other type of manual.  The cost of re-printing such would be terribly high
  116.  and unfair to pass this unneccessary cost on to you..  You would be placed
  117.  on our mailing list and would be notified immediately by mail of future
  118.  updates of File Magician and any new products we develop. The package will
  119.  be postage paid by us.
  120.  
  121.  
  122.  
  123. Now the Grit
  124. ~~~~~~~~~~~~
  125.     Now if you haven't already loaded File Magician you are one of the select
  126.  few.  Who reads the docs anyhow?  (g)  I'll try and keep it as brief as
  127.  possible, but please read below on "what you can do for us".
  128.  
  129. View Windows
  130. ~~~~~~~~~~~~
  131.     File Magician has two view windows.  One is the 'Source' and one is the
  132.  'Destination'.  The source window will always be the one with the red box
  133.  around it.  The Source and the Destination window can be swapped. To activate
  134.  a 'Source' window, click in the window itself or click in the path bar above
  135.  the window.  Once a 'Source' window is established the opposite window
  136.  automatically defaults to the 'Destination' window.    Often a directory will
  137.  have more file and directory listings then the view window can display.  Use
  138.  the scroll gadget to the right of the window to view the additional listings.
  139.  The bottom scroll gadget is inactive with this release but is there for
  140.  future compatability.
  141.  
  142. Selection
  143. ~~~~~~~~~~
  144.     The left mouse button (LMB) is used to select a file or directory. Clicking
  145.  once will select the listing and the listing will be hilited.  Double clicking
  146.  a directory will instruct the program to enter and display to the view window
  147.  that directory listing.  Double clicking a file listing causes No Action with
  148.  this release of File Magician.  The next release of File Magician will contain a
  149.  a smart mode file selection.  Smart Mode will be one of the main arteries of
  150.  File Magician!
  151.     When a file or directory is selected it means that the next command action
  152.  will be taken on all files and directories selected.  Changing to a different
  153.  directory will de-select automatically all of the previous selections.
  154.     No action will be taken on any file or directory that has Not been selected.
  155.  
  156. Title Bar
  157. ~~~~~~~~~~
  158.     The title bar is used as a action display.  There the program will show you
  159.  the current action that is taking place such as, copying, deleting, or moving
  160.  listings, bytes free on destination and source windows, files selected and
  161.  total bytes of selected files.  Currently there is a 5 second timer after a
  162.  title information display before it defaults back to a byte free display. This
  163.  may change to something else, what I'm not sure yet.
  164.  
  165. Keyboard:
  166. ~~~~~~~~~
  167.    F1   -  F1 activates "help mode".  When you active help mode you may then
  168.            click with the LMB on any item that you need help for.  A brief
  169.            help message will appear in the left view window.  Help mode will
  170.            then deactivate itself.  If you require more help you must press
  171.            F1 again.  To reset the left view window back to the file listings
  172.            press F2.  This method of help is designed for a 800x600 display.
  173.  
  174.    F2   -  F2 will re-display the file and directory listings on the left view
  175.            window.  This sometimes becomes necessary when de-compressing files
  176.            or using the help mode feature.
  177.  
  178.    F3   -  F3 will re-display the file and directory listings on the right view
  179.            window.
  180.  
  181.    ESC  -  Will exit the program.
  182.  
  183.  
  184. Buttons:
  185. **********
  186.  
  187.  Drive Buttons:
  188. ~~~~~~~~~~~~~~~
  189.     The first six buttons from the top of the screen are reserved for your
  190.  drive devices.  The program will automatically configure to the first six
  191.  drive names in the list.  Clicking the LMB on one of these will display the
  192.  root contents to the window that is active.  The view window will display
  193.  yellow text as directories and white text as file.  To enter a directory
  194.  double click the name of the directory.
  195.  
  196. Parent:
  197. ~~~~~~~
  198.     The 'Parent' button will direct the program to reassign the current
  199.  directory back one directory.  For instance, when you double click a directory
  200.  name the program will display the contents of that directory to the view
  201.  window, then you click the parent window, the program will re-display the
  202.  previous directory.  This command is completely harmless.  The parent button
  203.  only works on the 'Source' window.
  204.  
  205. All:
  206. ~~~~
  207.     The 'All' command will select all the files and all the directories that
  208.  are in the current directory of the 'Source' view window.  If a directory has
  209.  more files and directories then the view can be displayed, those files and
  210.  directories will also be selected.
  211.  
  212. Clear:
  213. ~~~~~~
  214.     'Clear' will de-select any file or directory that has been previously
  215.  selected.  All files and directories outside of the view window will also be
  216.  de-selected.
  217.  
  218. Copy:
  219. ~~~~~
  220.     To use the copy function, first select a view window that you wish to
  221.  become the Destination point.  Next go to the opposite window and select the
  222.  files or directories that you wish to copy.  Press the 'Copy' button.  Thats
  223.  it.
  224.     Copy will copy all files or directories that have been selected to the
  225.  Destination device (view window).  If a directory has been tagged, the
  226.  program will create and copy all files and directories within the selected
  227.  directory to the Destination point.  This release Does Not have an option to
  228.  check first to see if there is enough room in the destination area.  The next
  229.  registered release will.  You may use the 'Byte Req' button on the Source
  230.  directory before copying.
  231.  
  232. Rename:
  233. ~~~~~~~
  234.     To rename a file or directory first select the item then press the 'Rename'
  235.  button.  A dialog box will appear.  Enter in the new name excluding the full
  236.  path, the program keeps track of the location of the listings internally so
  237.  just the new name will be enough.  Select OK.
  238.  
  239. Move:
  240. ~~~~~
  241.     The move function will move all files and directories that have been
  242.  selected to the location of the destination area.  Moving a selected listing
  243.  means that basically the file is copied to destination area and then deleted
  244.  from the source area.  So once a listing is moved it will no longer reside
  245.  in the source area!  If a directory is selected, all files and directories
  246.  that are buried within that selected directory will also be moved.
  247.  
  248. Delete:
  249. ~~~~~~~
  250.    The 'Delete' button will delete all selected files and directories that have
  251.  been selected from the 'Source' window.  All files and directories that are
  252.  buried within a selected directory will Also be deleted.  With this version
  253.  of File Magician, when the 'Delete' is first invoked, a dialog box will appear
  254.  giving you the option of aborting.  A later version of the program will allow
  255.  you to discontinue this option.
  256.  
  257. Read:
  258. ~~~~~
  259.     The 'Read' function is a seperate program that File Magician calls to read
  260.  a text file.  The reason that I have done this is for future expandability!
  261.  I can think of a zillion different things that a read program should do and
  262.  I'm sure that you can too.  So for ease of development I'm doing it this way.
  263.  Currently the read function is set to read text files only.  It will read
  264.  anything but only text files will display properly.  The file size of the text
  265.  file is not important, there isn't a byte limitation.  There are three button
  266.  controls 'PageUp', 'PageDown', and 'Quit', also several keyboard controls are
  267.  present.
  268.     F1        = a brief help screen
  269.     PageUp    = up a screen page
  270.     U         = same
  271.     PageDown  = down a screen page
  272.     Space     = same
  273.     Enter     = same
  274.     D         = same
  275.     ESC       = exit read function
  276.     Q         = same
  277.  For best results read only one file at a time.  Multiple selections are
  278. possible but uses a lot of extra memory and it starts multiple instances of the
  279. read program.  Possibly in future versions I might be able to make Windows be
  280. a bit more behaved.
  281.  
  282. PkUnzip:
  283. ~~~~~~~~
  284.     PkUnzip will decompress any .zip file that has been selected in the 'Source'
  285.  window.  The decompressed files will sent to the destination area.  The
  286.  PkUnzip program must reside within an assigned directory, the dos directory for
  287.  instance.  File Magician will call PkUnzip and start a shell for PkUnzip to
  288.  do its work.  After the files have been decompressed press either F2 or F3
  289.  to re-evaluate the destination view window.  F2 = the left view window and
  290.  F3 = the right view window.  This will display the new contents of the
  291.  destination window.  This is neccessary because of Windows behavior that I'll
  292.  hopefully be able to fix in the future.
  293.     If you don't have PkUnzip, you should be able to obtain a copy of it from
  294.  your local dealer, user group, or BBS.  It is a fine program and I strongly
  295.  recommend that you register it promptly.
  296.  
  297.   COMPRESSION Functions
  298.  ~~~~~~~~~~~~~~~~~~~~~
  299.     File Magicians next registered update will have compression functions
  300.  for Lzh, Arj, and PkZip.  It will have functions for compressing and
  301.  de-compressing files and will have configuration options that you can set
  302.  within File Magician's Configuration.  If you are unsure of how to configure
  303.  these programs, a default generic configuration will be supplied.
  304.  
  305. Byte Req.:
  306. ~~~~~~~~~~
  307.     This function will total the bytes of all selected listings.  If a
  308.  directory is selected, all the bytes of all the files that are buried within
  309.  that selected directory will be totaled and displayed on the title bar at
  310.  the top of the screen.  This function is very handy to use before moving
  311.  or copying files to another device and just to know how large a directory might
  312.  be.
  313.  
  314. MakeDir:
  315. ~~~~~~~~
  316.     'MakeDir' will create a directory in the location that the 'Source'
  317.  window is displaying.  Push the 'MakeDir' button, a dialog box will appear.
  318.  Enter in the name of the new directory that you wish to create.  Press 'OK'
  319.  
  320. Config:
  321. ~~~~~~~
  322.    This command will activate the configuration program.  With this version
  323.  of File Magician the configuration program takes no active part in running
  324.  File Magician.  It is only present to show you what configuring File
  325.  Magician might be like.  With the next registered upgrade you will be able
  326.  to configure different functions of File Magician like the compression utils,
  327.  Warning boxes, palettes, etc.  The configuration program will save a data
  328.  file that File Magician will read when it starts up.  Configuration will
  329.  only need to be run once if your unsatisfied with the defaults and then again
  330.  if you desire any changes that you have previously made.  Here like the read
  331.  program this function has been made a seperate program, not only for future
  332.  expandability but also to save on program size.  You can run the configuration
  333.  program seperately if you wish where you can't with the read program.
  334.  
  335. Run:
  336. ~~~~
  337.    The 'Run' function will attempt start any program that has been selected.
  338.  'Run' works on: .pif , .bat, .exe (dos or windows), .com (dos or windows),
  339.  files.   A little care must be used when using this command, it is not harmful
  340.  but currently it has no way of checking to see how much memory an external
  341.  application will use.  Good judgement and a knowledge of how much memory your
  342.  computer has and how fast your computer is makes a large difference with
  343.  the results of this function.  Personally I haven't had too much trouble
  344.  using a 486(25) with 4 megs of memory and I was actually surprised on just
  345.  what it would handle.
  346.  
  347.  
  348. What You Can Do For Us!!!!
  349. ~~~~~~~~~~~~~~~~~~~~~~
  350.     Success of any software program depends on distribution and a good program.
  351.  We feel that we have a excellent program that everyone needs but getting
  352.  an evaluation copy of File Magician to everyone is impossible unless we have
  353.  your help.  We need you to upload the evaluation copy of File Magician to any
  354.  BBS that you might call that doesn't have it already, or to pass out a copy
  355.  to friends, club groups or anyone that you know that has a PC.
  356.    Secondly, register now, and get your friends to register now.  Registering
  357.  not only just pays the bills but it gives programmers incentive to create
  358.  more and better programs at a lower price, it keeps older experienced
  359.  programmers in the shareware field.  Only you can make it happen!!
  360.  
  361. Upload Description:
  362. ~~~~~~~~~~~~~~~~~~~
  363.    The following description might be a bit much, but sometimes it takes a
  364.  little to grab people attention (grin).
  365.  
  366.  FM.zip - File Magician V1.0 - for Windows 3.1
  367.           A Heavy Hitting program that ranks right
  368.           up there with the runaway hit 'Disk Master'
  369.           for the Amiga.  Full screen with Dual View
  370.           Windows, too much to list.  A must have for
  371.           all PC Users!! A Excellent File Management
  372.           Program!         Shareware.
  373.  
  374.   Ideas
  375.   ~~~~~
  376.     I like nothing better then hearing ideas from people!  If you have an idea
  377.  that you think File Magician should do, write it down either on disk or paper
  378.  and send it to my address.  Its far easier for me to implement something
  379.  that has a basic guideline that I can refer back to. (In calling voice the
  380.  concept is lost.)  If I use anyones idea, you will be acknowledged in the
  381.  Documentation for File Magician! But You must be a registered user.
  382.  
  383.  
  384.                  Thanks for Taking the Time..
  385.  
  386.                       Terry Bullard
  387.                        3291 Mt. View Rd.
  388.                         Ferndale, Wa. 98248
  389.                          (206)-384-6740 for ordering
  390.  
  391.  
  392.  
  393.  
  394.  
  395.